home *** CD-ROM | disk | FTP | other *** search
/ Grand Slam / GrandSlam volume 1.iso / 018 / far096.arj / ADDENDUM.DOC next >
Text File  |  1994-04-30  |  22KB  |  528 lines

  1. Addendum notes for the Farandole Composer DOX
  2. ---------------------------------------------
  3.  
  4. First of all, I want to apologize for not putting this info into the real doc
  5. files - it's just that i would basically have to rewrite the whole thing.
  6. In addition, I already have old printed copies to send to registered users.
  7. Here are the usage notes on the new features for this version.
  8.  
  9.  
  10. ** New for version .90
  11. ----------------------
  12.  
  13. MOD Saving for registered users
  14. -------------------------------
  15.  
  16. To save a MOD file if your copy is registered, simply turn on the channels you
  17. want to save, then press CTRL-F12. It will tell you what kind of MOD it saves,
  18. and this will be based on how many channels you have selected. It will save
  19. into these formats:
  20.  - 4,6,8 Channel FastTracker MODs
  21.  - 14,15,16 Channel TakeTracker MODs
  22. In addition, I am sending along each person's key file to expedite any problems
  23. you might have had in getting it to work correctly.
  24.  
  25.  
  26. EQ Bars Off
  27. -----------
  28.  
  29. Some people have been having problems with the new EQ bars. If it bothers you,
  30. simply use the switch /b to turn them off.
  31.  
  32.  
  33. Registration by keyfile
  34. -----------------------
  35.  
  36. If you have a key from me, use the command line switch /r. The rest will be
  37. fairly self explanatory. If you have not obtained a keyfile and you are a
  38. registered user, please contact me to get one. DO NOT leave netmail, or mail
  39. on my BBS. Instead, in this order: a) leave internet email, b) call Digital
  40. Oxygene BBS and leave mail, c) call voice and ask for me, d) Mail me. Letter
  41. C is risky; I may not be home, or I may be asleep (ARRRRG! :)
  42.  
  43.  
  44. PGUP/PGDN fixed
  45. ---------------
  46.  
  47. Due to excessive complaint by one certain annoying person :) I have added the
  48. CTRL-PGUP/DN keys that move a whole page without having to push them twice.
  49.  
  50.  
  51. Change drive command
  52. --------------------
  53.  
  54. You can now change drives in the file box - simply press D and it will ask for
  55. a new drive. It also returns you to the correct drive before exiting if you
  56. have changed drives.
  57.  
  58.  
  59. PANIC KEYS
  60. ----------
  61.  
  62. READ THIS CAREFULLY. USE THESE AT YOUR OWN RISK. These keys are what I define
  63. as 'panic keys'. The function of each is described below:
  64.  
  65. ALT-SHIFT-U: Unlock file i/o safeguard. If for some reason the program locks up
  66.              while doing file i/o you may press this key to regain control of
  67.              the keyboard handler.
  68. ALT-SHIFT-CTRL-`: This releases the keyboard handler routine. WARNING! You
  69.                   CANNOT, repeat CANNOT exit the program or use it in any way
  70.                   whatsoever once you press this. All this does is return
  71.                   control of the keyboard to the BIOS. This is useful if you
  72.                   get some kind of stupid QEMM error, you can then press 'T'
  73.                   to terminate (possibly saving your current DOS environment).
  74.                   This also (sometimes) allows you to use ALT-CTRL-DEL to
  75.                   reboot in case of a lockup.
  76.  
  77. DO NOT USE THE ABOVE KEYS UNLESS YOU ABSOLUTELY HAVE TO.
  78.  
  79.  
  80. Configuration screen
  81. --------------------
  82.  
  83. This new screen is brought up using ALT-F10. It shows some 'about' info at the
  84. bottom, and allows you to configure several options of Farandole. Use the
  85. context sensitive help and experiment to see what these do (most are pretty
  86. obvious).
  87.  
  88.  
  89. Individual pattern options
  90. --------------------------
  91.  
  92. You can now save and load individual patterns from your songs. They will be
  93. saved as .FPT files, in the same general format as all the other composer
  94. files. You can name the patterns to keep track of them (up to 32 chars). Load
  95. a pattern using SHIFT-F11, and save one using SHIFT-F12.
  96.  
  97.  
  98. 16 bit instruments
  99. ------------------
  100.  
  101. There are some serious problems with 16 bit instruments, that I have not been
  102. able to fix yet. The Gravis SDK gives no help with a small skimover, so it will
  103. take some asking around, etc to get this working. If you know how the Gravis
  104. treats 16 bit samples, please contact me.
  105.  
  106. ----------------------------------------------------------------------------
  107.  
  108. ** New for version .91
  109. ----------------------
  110.  
  111. Ambient Fine Tempo
  112. ------------------
  113.  
  114. Since it's rather hard to edit a song when you are using fine tempo, and it
  115. resets itself, the composer now does not reset fine tempo unless you do. You
  116. can accomplish this by using CTRL-4,1 on the number pad (same keys as for
  117. tempo adjustment, except with CTRL). You may also adjust it while the song is
  118. still playing. If you use fine tempo, make sure that you reset it at the
  119. beginning of each pattern so that it does not stack up (E0, then Ex).
  120.  
  121.  
  122. Abort mode
  123. ----------
  124.  
  125. I have added a few things that should help with the lockup/reboot on exit
  126. 'feature' that some people have had problems with :). But if all else fails,
  127. try the Borland C abort() function instead of a standard DOS exit by using the
  128. /a switch on the command line. Note that you can see if this worked - it prints
  129. 'abnormal program termination' when you quit. If you are not having problems
  130. and you use this switch, it will have no adverse effects.
  131.  
  132.  
  133. ----------------------------------------------------------------------------
  134.  
  135. ** New for version .92
  136. ----------------------
  137.  
  138. Loading Gravis Patch Files
  139. --------------------------
  140.  
  141. You can now load Gravis MIDI patch files as samples! When you try loading
  142. a file with the .PAT extension from the sample box, it will perform a check
  143. to see that it really is a patch file. From there it will automatically load
  144. the only sample if there's 1, or it will ask you which one to load if there
  145. are more. It attempts to preserve looping values, but there are some problems
  146. right now (not sure exactly). The sample name will be the filename of the
  147. patch file + the sample number (0 if only one sample). Patches are converted
  148. to 8 bit samples because 8 bit samples are easier to deal with, etc. Also
  149. this makes it easy to export them for use in MOD's and stuff..
  150.  
  151.  
  152. ----------------------------------------------------------------------------
  153.  
  154. ** New for version .93
  155. ----------------------
  156.  
  157. Additional on Gravis Patch files
  158. --------------------------------
  159.  
  160. I forgot to mention above, that you cannot load them straight from their
  161. directory. This is because FAR only allows directories with 256 filenames,
  162. and there are more patch files than that. Shell to DOS and copy over the one
  163. you want instead. I might fix this later on..
  164.  
  165.  
  166. Default Video Mode
  167. ------------------
  168.  
  169. You can now specify a default video mode on the CFG screen so that you don't
  170. have to use the /c switch anymore. To cancel this effect (in other words, if
  171. you change video cards, or something) use the /c switch again, and it will
  172. override the CFG settings. Since changes were made in the CFG file and there
  173. is some important info in there now, FAR will convert your old CFG file when
  174. it starts up to the new format (to make it stay you must press ALT-F10 to
  175. edit it then exit). Additionally, new version CFG files work with an older
  176. version of FAR, but some settings may not take effect depending on the version
  177. you are trying it with.
  178.  
  179.  
  180. Loading of names off
  181. --------------------
  182.  
  183. Now you can tell FAR not to load the song/sample names along with the
  184. directory in the loading box. This will speed up the directory process by
  185. a factor of TWENTY! It's also good if you have a slow computer. In the
  186. future I might rewrite the routine that does that in assembler, but not
  187. right now.
  188.  
  189.  
  190. Smart registration
  191. ------------------
  192.  
  193. Now if you can't figure out how to enter your name and number correctly, you
  194. can now enter your name in ANY case whatsoever, and your phone number in
  195. one of these formats:
  196.  
  197. +00000000000   (etc foreign, non-US)
  198. (000)000-0000  U.S. standard
  199. 1-000-000-0000 Another U.S. standard
  200. 000-000-0000   Another U.S. standard
  201.  
  202.  
  203. Sample Editor additions
  204. -----------------------
  205.  
  206. Now the sample editor caps off samples at 64k temporarily (for editing
  207. purposes). I forgot to mention before that you can hold down the press
  208. the right button after selecting a function and it will abort. Also the
  209. new function, optimize loop, will smooth out loop points at a position
  210. as close to your selected one as possible, to eliminate major pops in loops.
  211. The original point is taken from the first loop point first. The program
  212. searches within 100h bytes of the original for a match within +-10 amplitude
  213. bytes. If none close enough is found, it tries with the end loop point as
  214. the original. The closest match will be used. If none is found, no changes
  215. are made to looping values. You may also access this function using ALT-O
  216. from the sample menu on the main edit screen. However, a visual
  217. representation of the waveform from (ALT-E) will be much easier to make it
  218. perfect. Of course, you will have to realize that this function is not AI;
  219. it cannot perfect your looping for you. Only you can do that - with a little
  220. practice- and this AMAZING function! Please note also that some samples are
  221. already optimized - this function could quite possible screw them up! Be
  222. careful!
  223.  
  224.  
  225. >64k samples
  226. ------------
  227.  
  228. FAR composer (except the sample editor above) now FULLY supports >64k samples!
  229. This means you can load/save your favorite MODs/669s with samples up to 1
  230. meg in size. This also means that you will have to watch your memory; I've
  231. had reports of the composer CRASHING if you exceed the memory limit on your
  232. GUS.
  233.  
  234.  
  235. Default video mode
  236. ------------------
  237.  
  238. FAR now allows you to take the /c and /m switches off your command line and
  239. put the video mode in the config screen. I might add support for named video
  240. cards later, but for now, you can enter the number of the mode you want to
  241. use. If you use a /c or /m switch already, FAR will pick up your number and
  242. place it in the correct spot for you. Note that this number on the config
  243. screen is in HEX; as opposed to the command line switch, which is in decimal.
  244. Sorry for this inconvience, I'll have it fixed next version (they will
  245. probably both be hex).
  246.  
  247. -----------------------------------------------------------------------------
  248.  
  249. ** New for version .93r
  250. -----------------------
  251.  
  252. ULT loading
  253. -----------
  254.  
  255. ULT loading is NOT yet function correctly. So unless you want to crash your
  256. copy of the composer, don't try and load one yet! Taking the function out
  257. until it's done would be more trouble than its worth so..
  258.  
  259. -----------------------------------------------------------------------------
  260.  
  261.  
  262. ** New for version .94
  263. ----------------------
  264.  
  265. New effects!
  266. ------------
  267.  
  268. FAR now supports 4 new effects!
  269.  
  270. 7x       - Slide volume up x notches
  271. 8x       - Slide volume down x notches
  272. Ax       - Port to volume! This command, when given a volume on a line
  273.            will smoothly slide the current volume on the channel to the
  274.            volume specified in the number of bars specified. Its speed
  275.            parameter is identical to the port to note command.
  276. 9x       - Sustained vibrato. Ever get tired of putting all those 6x
  277.            commands? Use this one once, and cancel its effect with 90.
  278.  
  279. The volume ramp commands also have something weird with the upper and lower
  280. values (ie, a1, aA, aB, aD, aE, aF) when you change tempos. (strange? :).
  281. Usually tho the lower values will work fine for what you need until I fix
  282. the problem.
  283.  
  284. F2R Format
  285. ----------
  286.  
  287. FAR now saves in an F2R format. This format isn't very useful to the average
  288. user though. FAR doesn't even load them. The thing is, in our music disk/demo/
  289. game/whatever drivers we actually use, the FAR format is much too big and
  290. flabby. It's also slow.
  291.  
  292. This format on the other hand is built like a MIDI format, stored in events.
  293. These events tell only exactly what should be played, no blank space, etc.
  294. Developers may wish to use this format in their programs, and an OBJ file
  295. player will likely be released in the next version. It will include TC and
  296. ASM versions.
  297.  
  298. The compression of the F2R files is quite formidable. The format specs for
  299. the format will most likely be released with the next version. Until all of
  300. these things come out, I would advise against using the format for anything
  301. permanent (because it is likely to change, like the STX format).
  302.  
  303. To save a song in this format, simply press CTRL-ALT-SHIFT-F12 from the pattern
  304. edit screen. It will save XXXXXX.F2R (where XXXXX is your song name) in the
  305. last directory you used (if you loaded samples last, that's where it'll save
  306. it).
  307.  
  308. Hope it's useful.
  309.  
  310.  
  311. Volume UP/DN keys
  312. -----------------
  313.  
  314. These work just like the Octave/Note up/dn editing keys (ie, ALT-q/a, w/s),
  315. except they work off of volume. Quite useful feature, thanks Brad! :)
  316.  
  317.  
  318. Fixed lockups
  319. -------------
  320.  
  321. I was discussing lockups with someone and it just sorta hit me; Interrupts
  322. were occuring in the middle of my assembler screen write routines, and TC
  323. was not accustomed to having to worry about assembler code getting messed up.
  324. So... I sprinkled CLI's all over the code to make sure the player routine
  325. doesn't interrupt any vital assembler process (ie where segments are changed,
  326. etc). This small addition, which took me all of about 5 minutes, could quite
  327. possible be the end of most lockup problems. I also added some extra stack
  328. space and turned off stack checking - now Turbo C's stack will think it's
  329. overflowing, but it'll really flow over into my own stack segment. Thanks to
  330. Matt McLelland for this trick.
  331.  
  332.  
  333. JN-669 format
  334. -------------
  335.  
  336. I just received a copy of Unis669 today, and noticed that the main difference
  337. in his special file format is the "JN" in the header. So now Far will
  338. recognize and load these, but since most effects aren't loaded yet from his
  339. extended set, it probably won't sound completely right.
  340.  
  341.  
  342. Ultraclick Routing
  343. ------------------
  344.  
  345. Ultraclicks are a thing of the past! With a new volume ramper, and some new
  346. brains installed (duh :), I've fixed the problems we were having with
  347. clicking before. Also my ramp routine was nothing spectacular, thanks to
  348. JsNo BAR (author of unis669) for giving me his great ramping routine.
  349.  
  350.  
  351. ULT Loading
  352. -----------
  353.  
  354. ULT loading is still screwed up. In other words, don't try it unless you want
  355. something to complain about (lockups). It might or might not work, who
  356. knows... It's doing some strange things I can't figure out right now so...
  357.  
  358.  
  359. Keyboard extensions
  360. -------------------
  361.  
  362. Well, you asked for it guys.. here it is! Now all keys work up to P on the
  363. top row, and up to . on the bottom row. Hope this is enough :)
  364.  
  365.  
  366. Songtext Import Fixes
  367. ---------------------
  368.  
  369. I have completely redesigned the routines that load the songtext file. These
  370. were done in binary mode this time, with my own interpretation functions.
  371. Perhaps in a future version, I'll allow you to load color BIN files (ansi's
  372. etc) (if i figure out a way to do it without trashing compatibility).
  373.  
  374.  
  375. -----------------------------------------------------------------------------
  376.  
  377.  
  378. ** New for version .95
  379. ----------------------
  380.  
  381.  
  382. Reboot on exit
  383. --------------
  384.  
  385. So many people complained about FAR crashing on exit, each with different
  386. causes, etc. Since FAR is evil, and won't work on your computer correctly,
  387. I've tried to aid you in your quest to not reach over to push reset. Now
  388. FAR has a new, handy option to reboot FOR you on exit! (Check the config
  389. screen).
  390.  
  391.  
  392. Lockup fixes
  393. ------------
  394.  
  395. What was applied to the previous version in the screen routines has now been
  396. applied to the GUS routines as well. This covers all low-level code not
  397. handled by Turbo C. If it still crashes, I'm sorry. There's nothing I can
  398. do about it. Go have an orgy over another composing program like most people
  399. have chosen to do. Make sure you report back to me telling me how much
  400. better your new choice is. I was also thinking of adding an option to reboot
  401. your computer for you every 5 minutes (or a set interval). This would
  402. eliminate the troublesome and frustrating need to reboot your computer.
  403. Instead, FAR would save you the trouble by first saving your work and reboot
  404. your computer. (For those of you without a sense of humor, this paragraph
  405. has been largly satiricle).
  406.  
  407.  
  408. Note Offset Command
  409. -------------------
  410.  
  411. A new note offset command has been added (this is one of the last things I
  412. don't have that MOD's do that's useful!). This wonderful command will split
  413. up the current bar into 16 slices. It's just like using a 4F command, except
  414. the parameter tells the tracker WHICH slice to play on instead of playing on
  415. them all (it actually uses the retrigger code). Values greater than 4 usually
  416. don't work (too long). It depends on the tempo. The command value is C.
  417. Example, to play a note on slice 4/16:  C 210Fc4. Values of 1 and 2 are more
  418. realistic.
  419.  
  420.  
  421. Loading palette files
  422. ---------------------
  423.  
  424. A new option has been added in the config screen, to load the palette from
  425. any CFG file in the FAR format. The way you can make these is to do a color
  426. scheme, save the config, and rename or copy it to another filename. You may
  427. then load the colors from it here. Several sample color schemes have been
  428. included with this version in case you don't like the default.
  429.  
  430.  
  431. -----------------------------------------------------------------------------
  432.  
  433.  
  434. ** New for version .96
  435. ----------------------
  436.  
  437. Mode 255
  438. --------
  439.  
  440. I've created a pseudo 132x50 mode in VGA. I did not have time to play with
  441. the regs to actually get 132x43 (it's possible I think), but I will try in
  442. the future. In this, it uses 80x50 but you may use ALT-1/2 to scroll the
  443. screen left and right. Make sure that you are NOT on the sample box when you
  444. do this, because the ALT-# keys on the sample box reduce the number of bits
  445. in the currently highlighted sample.
  446.  
  447.  
  448. 669 Export
  449. ----------
  450.  
  451. Now FAR will export the first 8 channels of your song to an 8 channel 669!
  452. Keep in mind that EVERYTHING must be included within those channels (including
  453. tempo changes etc). Additionally, FAR will reload 669's with perfect quality,
  454. so you can save your song in that format for compression (EXCEPT FOR FAR-
  455. SPECIFIC EFFECTS!! If you use any FAR-Specific effects (like vibrato, slide
  456. etc) DO NOT USE THIS TO SAVE ALL YOUR SONGS! :)
  457.  
  458.  
  459. Global function register
  460. ------------------------
  461.  
  462. I have one effect left over.. 0! So I figure I would use it for something
  463. that would last a while. Well here it is.. It is the global function register.
  464. Each flavor of the effect has a different function (like ProTracker E fx):
  465.  
  466. 01- Turn volume ramp wait off \If you're using a lot of notes at once on a
  467. 02- Turn volume ramp wait on  /line, use 01 at the first and 02 at the end.
  468. 03- Allow loop fulfillment    - Will finish a note instead of looping it
  469. 04- Use modified FAR tempos   \ These are the fixed tempos.. FAR's tempos
  470. 05- Use standard FAR tempos   / were off for a while.
  471.  
  472. Ramp wait on/off
  473. ----------------
  474. If you read UPDATE.TXT, you'll see that I have a bad problem. One of the
  475. ultraclickers actually slows down the music if you use too many notes at
  476. once. Here's your solution! If you need to put on a LOT of them at once
  477. (I wouldn't recommend it anyway) you can put a 00 at the first of the row
  478. and an 02 at the end of the row. (Or you can just 01 and leave it that way,
  479. but it will sound worse I guarentee).
  480.  
  481. Allow loop fulfillment
  482. ----------------------
  483. Ever want to use things like MIDI samples etc that have something after the
  484. loop end? Here's your chance. Put this effect on any row before the note
  485. finishes and it will not loop. Obviously it will not stop the sample at
  486. that instant, but it will finish itself out and then stop.
  487.  
  488. Use modified/standard FAR tempos
  489. --------------------------------
  490. I've been using a VERY screwy method to use tempos slower than the timer
  491. allows. Here's your chance to use the technically correct tempos. Of course,
  492. these will screw up some songs that have critical timing (drumbeat samples,
  493. etc) so these two effects were put here to turn it on and off as you wish.
  494. These are also the tempos that are technically correct inside Composer 669.
  495. I also guarentee that the timing critical effects (ie note-port, vol-port,
  496. etc) will work much better under these tempos. I would highly recommend
  497. turning it on for new songs. (just put a 04 in the intro). You might also
  498. notice that these tempos can be completely different than the original FAR
  499. tempos. Be aware, however, that these tempos are completely correct, they
  500. have been tested. They operate at EXACTLY 32/tempo (like the original was
  501. supposed to). 669's ought to sound better if you use this effect at the top
  502. of them.
  503.  
  504. Note that except 03, these are fairly internal to FAR itself. You should
  505. probably ignore most of them in your own players... Also note that if you
  506. do not specify any of these effects, the songs will play as if in the
  507. far version .95 (volume ramping enabled). Also the newtempo will place an
  508. 'N' after the tempo on the status line, and volramps will place a 'V' in the
  509. first column.
  510.  
  511.  
  512. Song Loop handling
  513. ------------------
  514. I've had a resonable request to fix the order box where it will loop before
  515. a blank order rather than the last order number on the list. This means you
  516. can temporarily insert a pattern, etc to make the song loop if you are
  517. experimenting. If you have a normal song it will work same as usual.
  518.  
  519. "Single-Shot" sample loading
  520. ----------------------------
  521. A request has been mentioned to load several samples in one session because
  522. the directory scan takes so long. So here's what you can do!: Hit space on
  523. the loading box to load the current file into the current sample slot, and
  524. use the standard sample +/- keys (8,2 on the keypad) to change samples.
  525. Note that this also works when you are loading up a song so don't do it
  526. accidently.
  527.  
  528.